home *** CD-ROM | disk | FTP | other *** search
/ Aminet 5 / Aminet 5 - March 1995.iso / Aminet / dev / e / FDtoM_13.lha / FDtoM.doc < prev    next >
Text File  |  1994-10-03  |  3KB  |  139 lines
  1.  
  2.  
  3.                                FDtom
  4.                                ~~~~~
  5.  
  6.                     A small utility for Amiga_E
  7.                         By Detlef Riekenberg
  8.  
  9.                         Actual Version: 1.3
  10.  
  11.                                  ---
  12.  
  13.  
  14.                             1. Legal Stuff
  15.                             ==============
  16.  
  17.  FDtom is placed in the Public Domain for the Amiga.
  18.  
  19.  Feel free to use it, but AT YOUR OWN RISK, as I cannot be considered
  20.  responsible for any damage caused to your system. Have Fun!
  21.  
  22.  
  23.                             2. What is it?
  24.                             ==============
  25.  
  26.  - There was no Tool to Convert '.fd'-Files to MODULE's for Amiga_E,
  27.    so I write my own.
  28.  
  29.  - FDtom is a Shell-only program for all Amiga's.
  30.  - FDtom converts a Standard '.fd'-File in the special Form, needed by
  31.    Amiga_E. (The Library-Function-File "libname.m" for Amiga_E, and  a
  32.    "libname_lvo.m" with all LVOFUNKTIONNAME's for the Inline-Assembler).
  33.  - FDtom also generates "libname_lvo.i" for any Assembler (ASM-Switch).
  34.  
  35.  
  36.                             3. How to use
  37.                             =============
  38.  OS < 2.0:
  39.  - FDtom ignores SPACE and TAB and take the Rest of the Commandline
  40.    as the only Filename.
  41.  
  42. ---
  43.  OS >= 2.0:
  44.  
  45.  -FDtom uses the standard parser of OS 2.x. Start it with  a `?' as
  46.   argument and you will see the Pattern:
  47.  
  48.     FILES/A/M,RESOURCE/S,DEVICE/S,ASM/S
  49.  
  50.  -FILES/A/M:  You must put one or more Filename as Argument(s).
  51.  
  52.  -RESOURCE/S: FDtom will write the correct LVO-File for the E-Assembler,
  53.               the Name in the MODULE-Header is now correct.
  54.  
  55.  -DEVICE/S:   The Name in the MODULE-Header is now correct.
  56.  
  57.  -ASM/S:      FDtom creates a "libname_lvo.i"-File for other Assemblers.
  58.  
  59.  
  60. ---
  61.  ALL OS
  62.  - There is no Pattern-Matching for the Filename(s).
  63.  - The extensions '.fd' and '_lib.fd' are optional.
  64.  - The Output-Files are written to the Current Directory
  65.  - AmigaE is unable to use Funktion's with Offset: -6,-12,-18, and -24,
  66.    but the LVO-File for the Assembler is ok.
  67.  
  68.  
  69.  
  70.  
  71.                              4. Example
  72.                              ==========
  73.   
  74. ; FDtom - Example :
  75. ;
  76. ;  Go to the Destination-Dir
  77.   CD EModules:
  78.  
  79. ;  Convert ( OS <2.0)
  80.   FDtom fd:arp
  81.   FDtom fd:exec
  82.   FDtom fd:dos
  83.  
  84.  
  85. ;  Convert ( OS >=2.0)
  86.   FDtom fd:asl fd:exec fd:dos fd:misc
  87.  
  88. ; That's all :-))
  89. ;
  90.  
  91. ---------
  92.  
  93.  Dont't forget to add the new 'MODULE' to your Sources.
  94.  
  95.  E-Usage:
  96.         MODULE 'libname'
  97.         NewFunction(newargs)
  98.  
  99.  ASM-Usage:
  100.         MODULE 'libname_lvo'
  101.         JSR    LVONEWFUNCTION(A6)
  102.  
  103.  
  104.  
  105.  
  106.                            5. The Language
  107.                            ===============
  108.  
  109.  I  have used Amiga_E to write FDtom.  What?  E ?!  Yea!  Go and
  110.  see the source !!!  :-)
  111.  
  112.  The author of E language is:
  113.  
  114.       Wouter van Oortmerssen ($#%!)
  115.       Levendaal 87
  116.       2311 JG  Leiden
  117.       HOLLAND
  118.   
  119.   If you have access to Email:
  120.  
  121.       Wouter@alf.let.uva.nl    (E-programming support)
  122.   or: Wouter@mars.let.uva.nl   (personal)
  123.  
  124.  
  125.                             6. The Author
  126.                             =============
  127.  
  128.  
  129.  If you have bug-reports or suggestion's, please contact me:
  130.  
  131.  
  132.   Detlef Riekenberg
  133.   Otternhagener Strasse 73
  134.   31535 Neustadt
  135.   Germany
  136.  
  137.   FIDO    : 2:241/78.18
  138.  
  139.